+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * docs/debugging.txt: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS.
+
+ * gtk/gtkaccelgroup.c (gtk_accel_group_from_accel_closure,
+ gtk_accel_group_query, gtk_accel_group_find,
+ gtk_accel_groups_from_object): Document.
+
+ * gtk/gtkaccellabel.c (gtk_accel_label_set_accel_closure): Document.
+
2002-01-04 Hans Breuer <hans@breuer.org>
* gdk/gdkdraw.c gdk/gdkpixbuf-drawable.c :
+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * docs/debugging.txt: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS.
+
+ * gtk/gtkaccelgroup.c (gtk_accel_group_from_accel_closure,
+ gtk_accel_group_query, gtk_accel_group_find,
+ gtk_accel_groups_from_object): Document.
+
+ * gtk/gtkaccellabel.c (gtk_accel_label_set_accel_closure): Document.
+
2002-01-04 Hans Breuer <hans@breuer.org>
* gdk/gdkdraw.c gdk/gdkpixbuf-drawable.c :
+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * docs/debugging.txt: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS.
+
+ * gtk/gtkaccelgroup.c (gtk_accel_group_from_accel_closure,
+ gtk_accel_group_query, gtk_accel_group_find,
+ gtk_accel_groups_from_object): Document.
+
+ * gtk/gtkaccellabel.c (gtk_accel_label_set_accel_closure): Document.
+
2002-01-04 Hans Breuer <hans@breuer.org>
* gdk/gdkdraw.c gdk/gdkpixbuf-drawable.c :
+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * docs/debugging.txt: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS.
+
+ * gtk/gtkaccelgroup.c (gtk_accel_group_from_accel_closure,
+ gtk_accel_group_query, gtk_accel_group_find,
+ gtk_accel_groups_from_object): Document.
+
+ * gtk/gtkaccellabel.c (gtk_accel_label_set_accel_closure): Document.
+
2002-01-04 Hans Breuer <hans@breuer.org>
* gdk/gdkdraw.c gdk/gdkpixbuf-drawable.c :
+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * docs/debugging.txt: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS.
+
+ * gtk/gtkaccelgroup.c (gtk_accel_group_from_accel_closure,
+ gtk_accel_group_query, gtk_accel_group_find,
+ gtk_accel_groups_from_object): Document.
+
+ * gtk/gtkaccellabel.c (gtk_accel_label_set_accel_closure): Document.
+
2002-01-04 Hans Breuer <hans@breuer.org>
* gdk/gdkdraw.c gdk/gdkpixbuf-drawable.c :
+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * docs/debugging.txt: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS.
+
+ * gtk/gtkaccelgroup.c (gtk_accel_group_from_accel_closure,
+ gtk_accel_group_query, gtk_accel_group_find,
+ gtk_accel_groups_from_object): Document.
+
+ * gtk/gtkaccellabel.c (gtk_accel_label_set_accel_closure): Document.
+
2002-01-04 Hans Breuer <hans@breuer.org>
* gdk/gdkdraw.c gdk/gdkpixbuf-drawable.c :
+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * docs/debugging.txt: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS.
+
+ * gtk/gtkaccelgroup.c (gtk_accel_group_from_accel_closure,
+ gtk_accel_group_query, gtk_accel_group_find,
+ gtk_accel_groups_from_object): Document.
+
+ * gtk/gtkaccellabel.c (gtk_accel_label_set_accel_closure): Document.
+
2002-01-04 Hans Breuer <hans@breuer.org>
* gdk/gdkdraw.c gdk/gdkpixbuf-drawable.c :
G_DISABLE_CHECKS
If set, disable the g_return_if_fail and g_return_val_if_fail macros
-GTK_NO_CHECK_CASTS
+G_DISABLE_CAST_CHECKS
If set, don't check casts between different object types
--enable-debug=minimum [default]
Enable only inexpensive sanity checking
- sets GTK_NO_CHECK_CASTS
+ sets G_DISABLE_CAST_CHECKS
--enable-debug=yes
Enable all debugging support
--enable-debug=no (or --disable-debug)
Disable all debugging support (fastest)
- sets G_DISABLE_ASSERT, G_DISABLE_CHECKS, and GTK_NO_CHECK_CASTS
+ sets G_DISABLE_ASSERT, G_DISABLE_CHECKS, and G_DISABLE_CAST_CHECKS
Note that !G_DISABLE_CHECKS and --enable-debug=no are to be considered
not only fast, but dangerous as they tend to destabilize even mostly
- 2001-08-13 Matthias Clasen
- - 98/02/19 Owen Taylor
\ No newline at end of file
+ - 98/02/19 Owen Taylor
+2002-01-06 Matthias Clasen <matthiasc@poet.de>
+
+ * gtk/tmpl/gtktypeutils.sgml: Replace GTK_NO_CHECK_CASTS by
+ G_DISABLE_CAST_CHECKS, fix some markup and add stuff.
+
+ * gtk/tmpl/gtkaccelgroup.sgml, gtk/tmpl/gtkwidget.sgml: Additions.
+
+ * gtk/gtk-sections.txt: Make gtk_accel_group_get_type private.
+
2002-01-06 Havoc Pennington <hp@pobox.com>
* gtk/question_index.sgml: a few more questions I thought of
<FILE>gtkaccelgroup</FILE>
<TITLE>Keyboard Accelerators</TITLE>
GtkAccelGroup
-gtk_accel_group_get_type
gtk_accel_group_new
gtk_accel_group_ref
gtk_accel_group_unref
gtk_accelerator_name
gtk_accelerator_set_default_mod_mask
gtk_accelerator_get_default_mod_mask
+
<SUBSECTION Private>
GtkAccelGroupEntry
+gtk_accel_group_get_type
+
<SUBSECTION Standard>
GtkAccelGroupClass
GTK_TYPE_ACCEL_GROUP
<!-- ##### MACRO gtk_accel_group_ref ##### -->
<para>
-
+Deprecated equivalent of g_object_ref().
</para>
@Returns:
-<!-- # Unused Parameters # -->
-@accel_group:
<!-- ##### MACRO gtk_accel_group_unref ##### -->
<para>
-
+Deprecated equivalent of g_object_unref().
</para>
-<!-- # Unused Parameters # -->
-@accel_group:
-
<!-- ##### FUNCTION gtk_accel_group_connect ##### -->
<para>
<!-- ##### SECTION Long_Description ##### -->
<para>
-Gtk's type system is extensible. Because of that, types have to be
+The GTK+ type system is extensible. Because of that, types have to be
managed at runtime.
</para>
<!-- ##### TYPEDEF GtkType ##### -->
<para>
-@GtkType is unique integer identifying the type. The guts of the
+#GtkType is unique integer identifying the type. The guts of the
information about the type is held in a private struct named
#GtkTypeNode.
</para>
<!-- ##### MACRO GTK_CHECK_CAST ##### -->
<para>
-Casts the object in @tobj into @cast. If GTK_NO_CHECK_CASTS is
+Casts the object in @tobj into @cast. If %G_DISABLE_CAST_CHECKS is
defined, just cast it. Otherwise, check to see if we can cast @tobj
into a @cast.
</para>
<!-- # Unused Parameters # -->
-@tobj: a pointer to a GtkObject.
-@cast_type: a Gtk type.
+@tobj: a #GtkObject.
+@cast_type: a GTK+ type.
@cast: a C type
<!-- ##### MACRO GTK_CHECK_CLASS_CAST ##### -->
<para>
-Casts the object in @tobj into @cast. If GTK_NO_CHECK_CASTS is
+Casts the object in @tobj into @cast. If %G_DISABLE_CAST_CHECKS is
defined, just cast it. Otherwise, check to see if we can cast @tobj
into a @cast.
</para>
<!-- # Unused Parameters # -->
-@tclass: a pointer to a GtkClassInitFunc
-@cast_type: a Gtk type.
+@tclass: a #GtkClassInitFunc
+@cast_type: a GTK+ type.
@cast: a C type
</para>
<!-- # Unused Parameters # -->
-@type_object: A GtkTypeObject object.
+@type_object: a #GtkTypeObject object
@otype:
</para>
<!-- # Unused Parameters # -->
-@type_class: A GtkTypeClass class.
+@type_class: a #GtkTypeClass class.
@otype:
<!-- ##### MACRO GTK_CHECK_GET_CLASS ##### -->
<para>
-
+Gets the class of @tobj.
</para>
+@tobj: a #GtkObject.
<!-- ##### MACRO GTK_FUNDAMENTAL_TYPE ##### -->
<para>
-Converts a Gtk type into a fundamental type.
+Converts a GTK+ type into a fundamental type.
</para>
<!-- # Unused Parameters # -->
Defines a function pointer.
</para>
-@data: gpointer
-@Returns: gint
+@data: #gpointer
+@Returns: #gint
<!-- ##### USER_FUNCTION GtkDestroyNotify ##### -->
Defines a function pointer.
</para>
-@data: gpointer
+@data: #gpointer
<!-- ##### USER_FUNCTION GtkCallbackMarshal ##### -->
Defines a function pointer.
</para>
-@object: GtkObject*
-@data: gpointer
-@n_args: guint
-@args: GtkArg*
+@object: #GtkObject*
+@data: #gpointer
+@n_args: #guint
+@args: #GtkArg*
<!-- ##### TYPEDEF GtkSignalMarshaller ##### -->
<!-- ##### TYPEDEF GtkTypeClass ##### -->
<para>
-The base structure for a Gtk type. Every type inherits this as a base structure.
+The base structure for a GTK+ type. Every type inherits this as a base structure.
</para>
<!-- ##### FUNCTION gtk_type_init ##### -->
<para>
-Initializes the data structures associated with Gtk types.
+Initializes the data structures associated with GTK+ types.
</para>
@debug_flags:
Gets the internal representation of a type, given its name.
</para>
-@name: the name of a Gtk type
+@name: the name of a GTK+ type
@Returns: a #GtkType.
<!-- ##### MACRO GTK_WIDGET_TYPE ##### -->
<para>
-
+Gets the type of a widget.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_STATE ##### -->
g_object_unref (accel_group);
}
+/**
+ * gtk_accel_groups_from_object:
+ * @object: a #GObject, usually a #GtkWindow
+ * @returns: a list of all accel groups which are attached to @object
+ *
+ * Gets a list of all accel groups which are attached to @object.
+ */
GSList*
gtk_accel_groups_from_object (GObject *object)
{
return g_object_get_qdata (object, quark_acceleratable_groups);
}
+/**
+ * gtk_accel_group_find:
+ * @accel_group: a #GtkAccelGroup
+ * @find_func: a function to filter the entries of @accel_group with
+ * @data: data to pass to @find_func
+ * @returns: the key of the first entry passing @find_func. The key is
+ * owned by GTK+ and must not be freed.
+ *
+ * Finds the first entry in an accelerator group for which @find_func
+ * returns %TRUE and returns its #GtkAccelKey.
+ *
+ */
GtkAccelKey*
gtk_accel_group_find (GtkAccelGroup *accel_group,
gboolean (*find_func) (GtkAccelKey *key,
g_object_unref (accel_group);
}
+/**
+ * gtk_accel_group_query:
+ * @accel_group: the accelerator group to query
+ * @accel_key: key value of the accelerator
+ * @accel_mods: modifier combination of the accelerator
+ * @n_entries: location to return the number of entries found, or %NULL
+ * @returns: an array of @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is owned by GTK+ and must not be freed.
+ *
+ * Queries an accelerator group for all entries matching @accel_key and
+ * @accel_mods.
+ */
GtkAccelGroupEntry*
gtk_accel_group_query (GtkAccelGroup *accel_group,
guint accel_key,
return entries;
}
+/**
+ * gtk_accel_group_from_accel_closure:
+ * @closure: a #GClosure
+ * @returns: the #GtkAccelGroup to which @closure is connected, or %NULL.
+ *
+ * Finds the #GtkAccelGroup to which @closure is connected;
+ * see gtk_accel_group_connect().
+ */
GtkAccelGroup*
gtk_accel_group_from_accel_closure (GClosure *closure)
{
/**
* gtk_accel_groups_activate:
- * @object: the #Gobject, usually a #GtkWindow, on which
+ * @object: the #GObject, usually a #GtkWindow, on which
* to activate the accelerator.
* @accel_key: accelerator keyval from a key event
* @accel_mods: keyboard state mask from a key event
gtk_accel_label_queue_refetch (accel_label);
}
+/**
+ * gtk_accel_label_set_accel_closure:
+ * @accel_label: a #GtkAccelLabel
+ * @accel_closure: the closure to monitor for accelerator changes.
+ *
+ * Sets the closure to be monitored by this accelerator label. The closure
+ * must be connected to an accelerator group; see gtk_accel_group_connect().
+ **/
void
gtk_accel_label_set_accel_closure (GtkAccelLabel *accel_label,
GClosure *accel_closure)
projects / gtk4.git / commitdiff